home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / catscan1.zip / CATSCAN.DOC < prev    next >
Text File  |  1992-04-06  |  41KB  |  1,069 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                               C A T  S C A N
  12.                        =============================
  13.  
  14.                                  Wildcat!
  15.  
  16.                          A BBS Archive Maintainer
  17.                              And Virus Scanner
  18.                        ============================
  19.  
  20.                            From a Member of the 
  21.                           Wildcat! 3.0 Alpha Team
  22.                           =======================
  23.  
  24.                    Supports Single & Multi-Node Systems
  25.  
  26.                       Release Version 1.0u - 04/05/92
  27.                              (C)opyright 1992
  28.  
  29.                           The Software Connection
  30.                                 Mike Ortiz
  31.                              5237 SW 31st Terr
  32.                              Topeka, KS 66614
  33.  
  34.  
  35.                         The Software Connection BBS
  36.                      (913) 271-2070  USR DS 14400 (Locked)
  37.                      (913) 271-2071  USR DS 16800 (Locked)
  38.                      (913) 271-2072  USR DS 14400 (Locked)
  39.                      (913) 271-2073  USR DS 14400 (Locked)
  40.                      (913) 271-2074  USR HST 14.4 (Locked)
  41.  
  42.                           1200 / 16.8K   24 Hours
  43.  
  44.                              Fido Net  1:281/2
  45.  
  46.                        Magic Freq FileName: CATSCAN
  47.                           For The Latest Version
  48.  
  49.  
  50.                   (913) 271-2079 Voice (6PM-10PM Central)
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                      CATSCAN
  69.                                   =============
  70.  
  71.  
  72.  
  73.                                 Table of Contents
  74.                               =====================
  75.  
  76.      Support of Product..............................................1
  77.      Warranty........................................................1
  78.      Copyright.......................................................1
  79.      Distribution....................................................1
  80.      What Catscan Does...............................................1
  81.      Special Features................................................2
  82.      Setup and Installation..........................................4
  83.      Configuration...................................................5
  84.      Testing the Configuration.......................................9
  85.      Running Catscan as SCANFILE.BAT (.RUN).........................10
  86.      Running Catscan2 as an event...................................11
  87.      Licensing & Distribution Agreement.............................12
  88.      Acknowledgements...............................................13
  89.      Latest known versions of External Programs.....................13
  90.      Most Common Problems...........................................14
  91.      Support BBS's..................................................15
  92.      Special Thanks.................................................15
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.                                Support Of Product
  125.                             ========================
  126.  
  127.      I just want to ensure those that decide to register this product that
  128.      transmission of the registered key will be sent promptly or made 
  129.      availible for DOWNLOAD upon receiptm of your payment.  I want
  130.      to make it clear that CatScan is supported by me to the best of my
  131.      ability. If you have any problems with CatScan, I will try to solve
  132.      your problem as best as I can and as quick as possible.
  133.  
  134.  
  135.  
  136.                                    Warranty
  137.                                 ==============
  138.  
  139.      This product is provided "As Is" without warranty of any kind. The
  140.      entire risk as to the results and performance of the program is
  141.      assumed by you. Furthermore, I the author do not warrant, guarantee,
  142.      or make any representations regarding the use of, or the results of
  143.      the use of the program, and you rely on the program and results solely
  144.      at your own risk.  I the author cannot accept responsibility for
  145.      system damage, loss of profit, or any other special, incidental, or
  146.      consequential damages resulting from the use or inability to use this
  147.      product.
  148.  
  149.  
  150.  
  151.  
  152.                                    Copyright
  153.                                 ===============
  154.  
  155.      CatScan is distributed under the SHAREWARE concept. Under this concept
  156.      you may use the SHAREWARE (unregistered demo) version for a reasonable
  157.      period of time, which is thirty days.  After which you must either
  158.      register your copy or discontinue usage.
  159.  
  160.  
  161.                                  Distribution
  162.                               ==================
  163.  
  164.      You are free, in fact encouraged, to distribute the SHAREWARE
  165.      (unregistered) version of the CatScan provided that all files
  166.      contained in the original CATSCANx.ZIP archive are distributed in
  167.      their original unmodified state.
  168.  
  169.  
  170.  
  171.  
  172.                                What Catscan Does
  173.                              =====================
  174.  
  175.      Catscan will litterly let the user upload any kind of a file and it
  176.      will check it for integrity, the date of the files in the archive, TD0
  177.      files, Imbedded archives, recursed directories, unwanted files in the
  178.      archive and then if the newly uploaded file is not in the form of your
  179.      default archive it will change it to that form (Should only be used in
  180.      Catscan2 at this time) with out you lifting a finger.
  181.  
  182.      For instance, if an .ARC is uploaded it will be a .ZIP when Catscan2
  183.  
  184.  
  185.      is done.  If a TXT file is uploaded it will be a .ZIP when its done,
  186.      If they Upload a .TD0 file it will be a .ZIP when it's done (If you
  187.      add TD0 to the list in TXTNAMES.TXT). This way the User is not
  188.      returned a message "Sorry you will have to re-upload that 300k LZH you
  189.      just uploaded in .ZIP form" That wastes your time and the users time.
  190.      Why not let Catscan Deal with it..
  191.  
  192.      * Note *
  193.  
  194.      Until Wildcat implements the feature to change the archive
  195.      name on the fly only CatScan2 will allow you to convert files to your
  196.      default archive.  Hopefully it will be added shortly by Mustang.
  197.  
  198.  
  199.                           Special Features of CatScan
  200.                        =================================
  201.  
  202.      o    Checks integrity of uploaded files ZIP, ARJ, PAK, SDN, LZH, and
  203.           ARC. (Others can be added if there is a request).
  204.  
  205.      o    Checks Tele-disk's TD0 files for integrity.
  206.  
  207.      o    Checks Archived files in Archives for All Checks.
  208.  
  209.      o    Scans All files in the Archive for Viruses using the latest
  210.           version of SCAN from McAfee's.
  211.  
  212.      o    Will fail the file if the file dates are earlier than your
  213.           specified date. This also has two different ways to go, CatScan
  214.           will either fail the file if at least one file fails the date
  215.           check, and it will also work in the opposite manner.  Catscan
  216.           will only fail the file if none of the files passes the date
  217.           check, thus giving you all the flexibility to handle things the
  218.           way you want.
  219.  
  220.      o    Will re-archive any archive files that passes all tests with the
  221.           latest archive utility so you are sure it is an up to date
  222.           Archiving method. (This process can also be delayed and run in
  223.           your nightly .BAT file if you so desire).
  224.  
  225.      o    CatScan will convert any archive to a default archive that you
  226.           specify in the configuration.
  227.  
  228.      o    Will strip out other BBS's Authentic Verification and add yours
  229.           (if you have the registered version of PKZIP).  This is to let
  230.           the users know that your system has checked it for viruses if it
  231.           has your -AV on it.
  232.  
  233.      o    CatScan will add your BBS's .ZIP comment to the archive file if
  234.           you so desire (available in .ZIP and .ARJ only).
  235.  
  236.      o    Catscan will read in a .TXT file of file names created by you of
  237.           which it deletes if it finds in any archive. This will rid your
  238.           .ZIP files of the infamous README.COM and thousands of others
  239.           that are popping up.
  240.  
  241.  
  242.      o    CatScan will display current status to the users over the com
  243.           port. Com 1 - 8  are supported with Non-Standard IRQ and base
  244.  
  245.           addresses as well. It gives the user something to watch while
  246.           CatScan is working on the uploaded files.
  247.  
  248.      o    CatScan2 will maintain each directory on your hard drive
  249.           separately.  So New files that you add to the system can have the
  250.           CatScan treatment done to them with out you having to worry about
  251.           them.
  252.  
  253.      o    Catscan2 can operate by it's self on an entire directory, and can
  254.           be used in your nightly .BAT file to maintain all areas on your
  255.           BBS, processing only the files it hasn't processed before.
  256.           (Useful for Wildcat 2.x and 1.x)
  257.  
  258.      o    Easy configuration makes it so you don't have to have multiple
  259.           .CFG files, or a command line that has 6 different options on it
  260.           making it confusing and a pain just to run the program from the
  261.           dos prompt. In fact I write the .CFG into the .EXE file so you
  262.           never have to tell CatScan where to find the .CFG file.
  263.  
  264.      o    Added the RUNLATER.TXT text file that will add the ability to
  265.           process files and compress .gif files in your nightly .BAT file.
  266.           this can be used in several different ways. First, it will only
  267.           compress .GIF files in this way, second if you are running a
  268.           slower machine (XT), then this is a way for you to keep your
  269.           archives up to date with out making your users suffer the time
  270.           required to process a .zip file while they are on-line. 
  271.  
  272.      o    Supports Recursed Directories, and Volume labels of Zip files so
  273.           you won't loose those directories in Archived files.
  274.  
  275.  
  276.      o    CATSCAN2 will update the Wildcat database so If CATSCAN2 changes
  277.           the file to your default archive or converts a GIF then it will
  278.           change the Name and file size of the file (note this is only in
  279.           CATSCAN2).
  280.  
  281.  
  282.      o    CatScan has two different outputs available over the comport.  If
  283.           you are a registered Catscan user then you may take advantage of
  284.           this option.  It will display a rather pretty screen to the user
  285.           and move check marks around the screen while it is processing the
  286.           file. It is really hard to explain, but let me just say that it
  287.           looks very nice...
  288.  
  289.  
  290.      o    Catscan2 will read a ASCII text file of file extensions that
  291.           should be archived using your default archive. This allows you to
  292.           specify that all TXT, LST, and DOC files should be converted to
  293.           .ZIP to save space on your system, and maintain one type of file.
  294.  
  295.  
  296.      o    Catscan2 will convert your .GIF files with either GIF2JPG or
  297.           GIFLITE which ever you prefer.  After CatScan2 has finished, it
  298.           gets the new file size and updates the wildcat database to
  299.           reflect any changes. If you use JPG then it changes the file name
  300.           as well from .GIF to .JPG.
  301.  
  302.                             Setup and Installation
  303.                         ==============================
  304.  
  305.  
  306.      To install CatScan on your system simply copy Catscan.EXE to any dos
  307.      directory with a DOS PATH to it (preferable your \WC30 directory).
  308.      Then type in CATSCAN /C (you can do this as many times as you want as
  309.      your configuration may change).  The program will then ask you some
  310.      simple questions, answer them to the best of your knowledge. The first 
  311.      question that will be asked is the [I]mport [E]xport [C]ontinue 
  312.      question. For first time instalations you should pick the continue 
  313.      option to allow you to setup Catscan to your system.  Then After doing 
  314.      that you may run the Catscan /c again and use the export option.  This 
  315.      will allow you to save your configuration to a ASCII TXT file.  Then 
  316.      when new versions of catscan become availible all you will have to do 
  317.      to configure catscan again is import the ascii text file that you have 
  318.      of your configuration.  This makes updateing to a new version simple 
  319.      and painless.  After the configuration is done you can modify some of 
  320.      the files to fit your system. I recommend you run the program with the 
  321.      files I have provided for the first run. When you know the program is 
  322.      working properly then add more files to the BADNAMES.TXT file and 
  323.      setup your zip comment file.  If you want more names added to the 
  324.      BADNAMES.TXT file then use an ASCii editor and add all the filenames 
  325.      you want taken out of the archived files.  If you want your add put on 
  326.      the .ZIP comments then you may rename your TXT file (advertisement) to 
  327.      ZIP.CMM or just enter your TXT file name in the configuration program.
  328.  
  329.      Catscan contains the following files:
  330.  
  331.           CATSCAN.EXE  - Program used in SCANFILE.BAT
  332.           CATSCAN2.EXE - Program to run in nightly events
  333.           CATSCAN.KEY  - Needed to Run CATSCAN and CATSCAN2
  334.           CATSCAN.DOC  - This File
  335.           RUNLATER.TXT - Sample RUNLATER file
  336.           ZIP.CMM      - Sample ZIP Comments File
  337.           BADNAMES.TXT - Sample BADNAMES.TXT File
  338.           TXTNAMES.TXT - Sample file with file extensions.
  339.           SCREEN.SCR   - CatScan's High Graphics display screen (Should be
  340.                          in the same directory as CATSCAN.KEY)
  341.           EXCLUDE.XXX  - How to exclude directoris from being processed
  342.           SCANFILE.BAT - Example SCANFILE.BAT for Multi-Lines
  343.           README.1ST   - Important information you should read
  344.           VERSION.?    - Information on what was added in this version
  345.  
  346.      In addition to the above, you will need the following files to take
  347.      full advantage of CatScan, these files must exist in the DOS path.
  348.  
  349.           PKZIP.EXE      Zip Archiver
  350.           PKUNZIP.EXE    Zip UnArchiver
  351.           SCAN.EXE       Virus Scanner
  352.           TDCHECK.EXE    TD0 Checker (Tele-Disk Files)
  353.           ARJ.EXE        ARJ Archiver/Un-Archiver
  354.           LHA.EXE        LZH Archiver/Un-Archiver
  355.           PAK.EXE        PAK Archiver/Un-Archiver
  356.           QARC.EXE       ARC Archiver Does all versions of ARC
  357.           XARC.EXE       ARC Un-Archiver Does all versions of ARC
  358.           Giflite or     GIF File Compressor
  359.           GIF2JPG
  360.  
  361.      If you do not have all the unarchivers and would still like to check 
  362.      out the program with the archivers you do have then for the ones you 
  363.      don't have copy pkzip.exe to the name of the archiver your missing and 
  364.      catscan will just think that is ARJ.EXE even though it is PKUNZIP.EXE 
  365.      that has had the name changed.  This is also an effective way to make 
  366.      catscan reject any files of a particular type that you do not wish to 
  367.      have uploaded.  For Example lets say you do not want ARJ file Period!  
  368.      Then if you copy pkunzip.exe to arj.exe when an .ARJ file is uploaded 
  369.      Naturally Pkunzip.exe does not know hoe to unarchive the ARJ files so 
  370.      it will fail the file because of integrity.
  371.  
  372.      Any of these files can be downloaded from The Software Connection, on
  373.      the first call, no need to get verified, just go to the file directory
  374.      and you will see them all available in the Free Files Area. The entire
  375.      collection are contained in SCANUTIL.ZIP.  For those running D'Bridge,
  376.      Frontdoor, Binkely etc, you may FREQ any of these files by using the
  377.      program's name without the extension; ie; PAK To obtain PAK.EXE,
  378.      SCANUTIL to obtain SCANUTIL.ZIP etc.
  379.  
  380.  
  381.  
  382.  
  383.                              Configuration Program
  384.                          ============================
  385.  
  386.      The configuration program is internal in the .EXE program when you
  387.      modify your configuration you actually modify the data in the .EXE
  388.      file.  This makes it very easy to run the program with less parameters
  389.      on the command line.  Since nothing changes in the configuration it
  390.      makes it easy for you to tailor it to your system.
  391.  
  392.      To run the Configuration program simply type CATSCAN /C  and the
  393.      configuration screen will appear.
  394.  
  395.      * Note *
  396.  
  397.      Whatever appears on the Change From Line is the default.  If you
  398.      desire to accept these defaults, JUST PRESS ENTER.
  399.  
  400.      You will see the following:
  401.  
  402.      Change Your Temp Drive from C:
  403.  
  404.      TO:
  405.  
  406.      Temp Drive -   This is the drive you want Catscan to make a
  407.                     temporary working directory, make sure this drive has
  408.                     enough space to handle your biggest .ZIP file I don't
  409.                     check for drive space right now.  CatScan will remove
  410.                     this directory after its done running. Default is C:
  411.  
  412.  
  413.  
  414.  
  415.      Change Your BADNAMES.TXT From: C:\CATSCAN\BADNAMES.TXT
  416.  
  417.      TO:
  418.  
  419.      BADNAMES.TXT File - This is any .TXT file that has the names of the
  420.                          files you want deleted out of the .ZIP's specify
  421.                          one file per line. Catscan will automatically add
  422.                          this file to the directory you specified or the
  423.                          default, and add COMMAND.COM to it.
  424.  
  425.      Your Log File Drive/Path/First Name Only:  Currently C:\WC30\ACTIVITY
  426.  
  427.      TO:
  428.  
  429.      CatScan Log File - Specify the Drive\Directory\Filename of the
  430.                         file you want to be the log of activity.  If you
  431.                         want it to log to Wildcat!'s activity log then you
  432.                         must specify the drive\path\First part of the
  433.                         filename. In this case the first part would be
  434.                         ACTIVITY since Wildcat!'s logs start with ACTIVITY.
  435.                         If Catscan is run from the DOS prompt it will use
  436.                         the log name then append .000 to the log filename.
  437.  
  438.  
  439.  
  440.  
  441.      Change Your ZIP Comment File From: C:\CATSCAN\ZIP.CMM
  442.  
  443.      TO:
  444.  
  445.      Zip Comment File - This TXT file contains your BBS Advertisement.
  446.                         If you don't want an advertisement put on the .ZIP
  447.                         files then just make this .TXT file empty with 1
  448.                         space.  This file must exist for Catscan to
  449.                         function. This will also remove the old comment.
  450.  
  451.      CATSCAN.KEY is in What Directory: C:\CATSCAN\CATSCAN.KEY
  452.  
  453.      TO:
  454.  
  455.      Ensure that your CATSCAN.KEY is in the directory you specify. and make 
  456.      sure that you put the entire name in the config too.  for example if 
  457.      your catscan.key was in the wc30 dir then the corrent answer to the 
  458.      question would be:  C:\WC30\CATSCAN.KEY
  459.  
  460.  
  461.      RUNLATER.TXT Should Be Put Where   Currently: C:\CATSCAN\RUNLATER.TXT
  462.  
  463.      TO:
  464.  
  465.      The RUNLATER.TXT file is used only for CatScan2 to know what files 
  466.      were uploaded to your system for the day, so in the nightly bat file 
  467.      when you run Catscan2 it will read and process every file that is in 
  468.      this txt file.  I can also be used in conjuncion with BUILDCAT.ZIP 
  469.      (Availible on the support BBS)  and process any give files using 
  470.      wildcards.  For example, say you have a directory of 100 .ZIP's and 10 
  471.      ARJ's and you want to conver the ARJ's to ZIP's then you could process 
  472.      *.ARJ using Buildcat and it will create the Runlater.txt file with 
  473.      those files in it then you just run Catscan2 and it will process only 
  474.      those files. 
  475.  
  476.  
  477.      
  478.      The next 5 sets of questions are going to ask you to define your 
  479.      archivers the first part is the name, include the name and extension. 
  480.      If you want to use the archiver that is the default then just press 
  481.      enter on the name and CatScan and CatScan2 will search your DOS PATH 
  482.      for you and return the location of the file.
  483.  
  484.      You can also specify excatly where Catscan and Catscan2 should look 
  485.      for the archivers even if they are not in the DOS path just type in 
  486.      the full path and filename and if Catscan find the file in the 
  487.      specified directory then it wont go out and search the DOS PATH.  This 
  488.      is usefull especially right now I use the PKUNZIP ver 1.93 to 
  489.      unarchive the archives and PKZIP 1.10 to Archive them since the 2.0 
  490.      version of PKZIP is not realeased yet but we are still receiveing 
  491.      files that have been archived with this version.  The only way to 
  492.      uncompress them is with that version.  The second part asks for the 
  493.      parameters to make the archiver uncrunch and crunch the files.
  494.  
  495.  
  496.      Define your ZIP Archiver :  PKZIP.EXE
  497.  
  498.      TO :
  499.  
  500.      What are the params: -r -p (For people with -AV use -! -r -p)
  501.  
  502.      TO:
  503.  
  504.      Define your ZIP Un-Archiver: PKUNZIP.EXE
  505.  
  506.      TO:
  507.  
  508.      What are the params: -o -d
  509.  
  510.      TO:
  511.  
  512.      Define your LZH Archiver :  LHA.EXE
  513.  
  514.      TO :
  515.  
  516.      What are the params: a
  517.  
  518.      TO:
  519.  
  520.      What are the params to Un_ARC: e
  521.  
  522.      TO:
  523.  
  524.      Define your ARC Archiver: QARC.EXE
  525.  
  526.      TO:
  527.  
  528.      What are the params: a
  529.  
  530.      TO:
  531.  
  532.  
  533.  
  534.      Define your ARC Un-Archiver :  XARC.EXE
  535.  
  536.      TO :
  537.  
  538.      What are the params: /o
  539.  
  540.      TO:
  541.  
  542.      Define your PAK Archiver: PAK.EXE
  543.  
  544.      TO:
  545.  
  546.      What are the params: a
  547.  
  548.      TO:
  549.  
  550.      What are the params to Un-Pack: e
  551.  
  552.      TO:
  553.  
  554.      Define your ARJ Archiver: ARJ.EXE
  555.  
  556.      TO:
  557.  
  558.      What are the params: a
  559.  
  560.      TO:
  561.  
  562.      What are the params to Un-ARC: e
  563.  
  564.      TO:
  565.  
  566.  
  567.      Should I write GIF files to the RUNLATER.TXT file to compress them in
  568.      your nightly .BAT file:  NO
  569.  
  570.      (Y/N)
  571.  
  572.      What is the oldest date in the Archive to Pass: 01/01/80
  573.  
  574.      Change Month to:
  575.  
  576.      Change Day to:
  577.  
  578.      Change Year to:
  579.  
  580.  
  581.      Should I fail the file If just some of the files are older than the 
  582.      date specified (Y/N) ? NO
  583.  
  584.      This option might be one of the more confusing questions in the 
  585.      configuration.  What it means is that some programs use the same data 
  586.      files or DOC files but the program themselves have been updated. In 
  587.      cases like this you wouldn't want to fail the file because the program 
  588.      itself passes your date scan.  If this is the type of operation you 
  589.      desire then set this option to NO.  If you want to be as strict as 
  590.      possible then set this option to YES.
  591.  
  592.                                                                                                                                          
  593.      if you don't want the feature enabled then leave it at 01/01/80  and 
  594.      catscan will not check the date in the archive.  Setting it to 
  595.      anything before 01/01/80 will cause Catscan to use the year 2000 
  596.      instead of 1900 so don't.
  597.  
  598.           ie. year 79 is 2079
  599.  
  600.  
  601.  
  602.  
  603.      Do you want ZIP files that had nothing deleted from them displayed in
  604.      the log: YES
  605.  
  606.      (Y/N)
  607.  
  608.      This option is a little strange but I saw a need for it.  If you get a
  609.      lot of files from a BBS that had advertisement TXT files, then you may
  610.      want this option enabled. It will help you catch BBS advertisements
  611.      that may be in the archives. This will then allow you to add those
  612.      names to your BADNAMES.TXT file. If the majority of your uploaded
  613.      files don't have advertisements in them then you may not want to use
  614.      the option.
  615.  
  616.  
  617.      Do you want me to put your comment on the file at the time of the 
  618.      upload (Only works for ZIP and ARJ) (Y/N)? Yes
  619.  
  620.      Do you want me to write all archives to the RUNLATER.TXT file so that 
  621.      Catscan2 can process them in your nightly BAT file? (Y/N): YES
  622.  
  623.      (Y/N) : Y
  624.  
  625.  
  626.  
  627.      Settings for Catscan2 are the same as Catscan except for the following 
  628.      questions.
  629.  
  630.  
  631.      Should I move files that fail for any reason to a BAD directory 
  632.      (Y/N) : No
  633.  
  634.  
  635.      This option is pretty much up to you on how you want to handle it. I 
  636.      personally dont move the files, because if there is something wrong 
  637.      with the file Catscan would have already cought it at the time of the 
  638.      upload.  However those processing a directory by itself then you may 
  639.      want any of the bad files moved out of that directory,  but Catscan2 
  640.      logs any failed files in the LOG file like ACTIVITY.000 if a file 
  641.      passes so you could then review that log as well and see if any files 
  642.      failed..  Its your choice.
  643.  
  644.      People Using wildcat ver 2.x or another BBS program will want to say 
  645.      YES to this option since Catscan will not be able to flag the file as 
  646.      BAD in the BBS Database.  (It will only do this for ver 3.x of 
  647.      Wildcat!)
  648.  
  649.      If You answer No to the above question then the question below will
  650.      not be asked.
  651.  
  652.      Change Your Bad File Dir From: C:\BAD
  653.  
  654.      TO:
  655.  
  656.      BadFileDir - This is a Drive\Directory of the place CatScan2 will put
  657.                   files that either failed any tests or have a virus. Makes
  658.                   it easy to see if any action has come up.  Catscan2 will
  659.                   automatically create this directory for you if it does
  660.                   not already exist.
  661.  
  662.  
  663.      What Is Your Default Archiver   Currently selected: 1
  664.  
  665.      1 - ZIP
  666.      2 - LZH
  667.      3 - ARC
  668.      4 - PAK
  669.      5 - ARJ
  670.  
  671.      Change it To:
  672.  
  673.      This tells Catscan2 What Default archive type you prefer to have all 
  674.      your archives converted to.
  675.  
  676.      Do you want me to convert all Archives to your default Archive: NO
  677.  
  678.      (Y/N)
  679.  
  680.      Answering No to this question will tell catscan not to convert any 
  681.      files over to a different type archive format.  Catscan2 will still 
  682.      process the file and rearchive it but it will remain in its original 
  683.      archiver format.
  684.  
  685.  
  686.      Should I Just scan the file and not touch it in any way? 
  687.      (Answering Yes will leave anyone's -AV intact): NO
  688.  
  689.      (Y/N)
  690.  
  691.      This feature would manly be used to just scan an entire directory for 
  692.      viruses and integrety.  For example if you just aquired Catscan and 
  693.      want to have it check all your existing archives for viruses or 
  694.      integrity then set this question to YES and thats what it will do..  
  695.      If you want it to recompress the file with the latest archiver and 
  696.      Scan and check for integrity then this question must be set to NO
  697.      
  698.  
  699.  
  700.  
  701.                            TESTING THE CONFIGURATION
  702.                           ===========================
  703.  
  704.      At this point the configuration is completed and you are ready to test
  705.      the program out.  Make a temp directory and copy a couple .ZIP files
  706.      to that directory then type in CATSCAN C:\TEST\FILENAME.ZIP.  
  707.  
  708.      Some examples might look like this:
  709.  
  710.      * Note *
  711.  
  712.      CATSCAN does one file at a time, CATSCAN2  will do a directory.
  713.  
  714.      CATSCAN C:\TEMP\TESTFILE.ZIP (Processes the file TESTFILE.ZIP)
  715.      CATSCAN G:\UPLOADS\MYFILE.ZIP
  716.      CATSCAN D:\WC30\UPLOADS\THISFILE.ARJ
  717.  
  718.      Example CATSCAN2 parameters
  719.  
  720.      CATSCAN2 C:\TEMP  (Process the Temp directory on C:)
  721.      CATSCAN2 H:\UPLOADS (Process the Uploads dir on H:)
  722.      CATSCAN2 D:\WILDCAT\UPLOADS\TEMP
  723.      CATSCAN2 \TEMP (Process the TEMP dir on the current Drive)
  724.      CATSCAN2 Will process all files out of the RUNLATER.TXT file
  725.      CATSCAN2 C:\UPLOADS\MYFILE.ZIP Process just that file.
  726.  
  727.      If the program works fine then you have installed it correctly if
  728.      there is a problem then check to make sure all the files you specified
  729.      in the configuration options are where you said they are.
  730.  
  731.      Make sure that the BADNAMES.TXT has at least one file in it, I put
  732.      COMMAND.COM in there because this is one filename no one needs
  733.      duplicates of.  Make sure you specify a filename for the .ZIP comment
  734.      even if its contents are empty. If the above works fine then you are
  735.      ready to put it on-line for your users to begin using.
  736.  
  737.      We now know that the program is set up fine, and it is in our DOS PATH
  738.      so we don't need to do anything except make the SCANFILE.RUN or .BAT
  739.      file to run the program.
  740.  
  741.  
  742.  
  743.                      RUNNING CATSCAN AS SCANFILE.BAT(RUN)
  744.                     ======================================
  745.  
  746.      If you are running a multi node or single node system then you can
  747.      just use the SCANFILE.BAT to run all your nodes with.  The following
  748.      is the format.
  749.  
  750.           SCANFILE.BAT  (This file goes in your Wildcat directory)
  751.           ------------
  752.           CD \WC30\WCWORK\NODE%WCNODEID%
  753.           CATSCAN %1
  754.  
  755.      One thing to make sure of with this configuration is that If you are
  756.      running a single line version the only way for the above method to
  757.      work is if you have used the SET option in your bat file that calls up
  758.      wildcat.  For example  you must have had this line in your .bat file
  759.      that started wildcat.
  760.  
  761.      SET WCNODEID=1  (The 1 Means Node 1, 2 would mean Node 2 ect...) Also
  762.      multi line versions will have to define this variable for each node.
  763.      It can't be left off of any of them.
  764.  
  765.      For Single line versions that don't want to define the environment
  766.      variable then you can use the SCANFILE.RUN located in the node1
  767.      directory to run catscan.  it would look like this..
  768.  
  769.           SCANFILE.RUN   (Located in the WC30\WCWORK\NODE1 directory)
  770.           ==============
  771.           CD \WC30\WCWORK\NODE1
  772.           CATSCAN %1
  773.  
  774.      Or you can also use the SCANFILE.BAT and just use the same contents as 
  775.      the above example.
  776.  
  777.  
  778.  
  779.  
  780.  
  781.                          RUNNING CATSCAN2 AS AN EVENT
  782.                         ==============================
  783.  
  784.      CATSCAN2.EXE will run in your nightly BAT file and compress any newly
  785.      uploaded .GIF files to either JPG or GifLite your choice. It will
  786.      process your archives if you told CatScan to process the archives in
  787.      your nightly BAT file.  It will Process files from either the
  788.      RUNLATER.TXT file or from the directory passed on the command line, or
  789.      even just one File.  CATSCAN.DAT is only used if you put a directory
  790.      on the command line.  This will allow you to keep a directory in order
  791.      or to just update them.  The following are examples of how it works..
  792.  
  793.           CATSCAN2 C:\UPLOADS (Process the upload directory and
  794.                               create CATSCAN.DAT to know where
  795.                               CatScan2 Left off)
  796.  
  797.           CATSCAN2 C:\UPLOADS\NEWFILE.ZIP (Process only the file
  798.                                            NEWFILE.ZIP in the
  799.                                            upload Directory)
  800.  
  801.           CATSCAN2   (Catscan2 expects to find the RUNLATER.TXT
  802.                       file where it was specified in the config
  803.                       then it will process all the files in the
  804.                       RUNLATER.TXT file)
  805.  
  806.  
  807.  
  808.  
  809.  
  810.                     Explanation of Command Line Parameters
  811.                  ============================================
  812.  
  813.      FileName       This option tells CatScan or Catscan2 that you are
  814.      or             going to be providing it with the Drive/Path/Filename
  815.      %1             of the file that you want to be checked.  It also
  816.                     disables any Delays in the program. (BBS/Stand Alone
  817.                     Option)
  818.  
  819.  
  820.      Dir            This option will tell CatScan2 to process an entire
  821.      or             directory. Note that you put the directory name here
  822.      \UPLOADS       not DIR.  The Dir name must be a complete Drive\Path
  823.                     unless you want the DIR on the current drive to be
  824.                     processed then just the Path is needed.  If CatScan has
  825.                     never run in that Directory, then it will process every
  826.                     .ZIP file in there. If it has run in that directory it
  827.                     will only process the .ZIP files with a date later than
  828.                     when CatScan last ran.  CatScan Creates the file
  829.                     CATSCAN.DAT in the directory after it runs.  This lets
  830.                     CATSCAN know when the last time it ran in a particular
  831.                     directory. (Stand Alone Option)
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.                  CatScan LICENSING AND DISTRIBUTION AGREEMENT
  842.                 ==============================================
  843.  
  844.  
  845.      You may not incorporate parts of CatScan into other programs with out
  846.      written permission from Mike Ortiz Permission may or may not be
  847.      granted based upon a determination of how your intended use.
  848.  
  849.      You must keep this License Agreement intact and give any other
  850.      recipients of the CATSCANx.ZIP program a copy of this License
  851.      Agreement along with the program.
  852.  
  853.      Catscan is still in the process of being completed, but is a very
  854.      functional piece of software as it is. You should be aware that if you
  855.      register you will receive the final version of Catscan 1.0 with no
  856.      additional cost to you. If you choose for me to mail you a disk then a
  857.      disk will be mailed at the time 1.0 is completed.  I don't see any
  858.      reason to mail Beta versions out to people who expect a nice looking
  859.      disk and completed piece of software.  If you like the direction that
  860.      catscan is going then Please send in your registration to help support
  861.      my efforts in this project.
  862.  
  863.  
  864.      Don't be fooled by clones of Catscan there is still to this date no
  865.      utility that does what catscan does for Wildcat. CatScan will update
  866.      your Wildcat database for you, eliminating one of the most time
  867.      consuming processes for the SysOp.  Writes Activity out the Serial
  868.      port so the users can see what is happening, instead of just a blank
  869.      screen. Finally it converts archives to a default archive and
  870.      compresses GIF files in two different ways make sure another utility
  871.      does this before you compromise options for price.  As an added
  872.      benefit I am giving free access to my BBS to any registered users of
  873.      Catscan.  The Software Connection can be used for Support on Catscan,
  874.      Wildcat 3.0, and any Utilities for 3.0,  I Have 5 lines Locked at 19.2 
  875.      See the Begining of this document to see which line will fit you best. 
  876.      The Support System has roughly 6.5 gigs Of Space, over 45,000 files, 
  877.      Lots Of Wildcat Utilities and Doors.  So With your registration you 
  878.      not only get a good program but great place for support, questions, 
  879.      and plenty of files to post on your own BBS.  All have been scaned 
  880.      With CATSCAN.  Who else can offers you type of deal?
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.      Acknowledgements:
  904.  
  905.      o    Wildcat! (tm)  (c) Mustang Software, Bakersfield, CA.
  906.  
  907.      o    These programs were written using Turbo Pascal 6.0 from
  908.           Boreland International, Scotts Valley, CA.
  909.  
  910.      o    SCAN (c) 1989-1992 by McAfee Associates.
  911.  
  912.      o    PkPak, PkUnPak, PkZip (tm), and PkUnZip (tm) (c)
  913.           1986-1992  by Philip W. Katz, PKWARE Inc.
  914.  
  915.      o    LHarc and LHA (c) 1988-1989 by Haruyasu Yoshisaki.
  916.  
  917.      o    Pak (c) 1988-1989 by NoGate Consulting.
  918.  
  919.      o    Arj (c) 1990-1992 by Robert K. Jung.
  920.  
  921.      o    Qarc and Xarc (c) 1990 System Enhancement Associates
  922.  
  923.      o    TDCheck (c) 1990  by Sydex Inc.
  924.  
  925.      o    GifLite (c) 1991 by Tsung Hu
  926.  
  927.      o    Gif2JPG (c) 1990-1991 by Handmade Software Inc.
  928.  
  929.  
  930.  
  931.  
  932.      Latest Known Versions of External Programs are:
  933.  
  934.      Compressed File    Version   Exe File      Explanation
  935.      --------------     -------   ------------  ----------------------
  936.      SCANV89B.ZIP          89B    SCAN.EXE      Virus Scan Program
  937.                                                 by McFee
  938.      ARJ230.EXE           2.30    ARJ.EXE       Process *.arj files
  939.      LH113C.EXE           1.13c   LHARC.EXE     Process *.lzh files
  940.      LHA212.EXE           2.12    LHA.EXE       Process *.lzh files
  941.      PAK251.EXE           2.51    PAK.EXE       Process *.pak & *.sdn
  942.                                                 files
  943.      QARC.EXE             1.0     QARC.EXE &
  944.                                   XARC.EXE      Process *.arc files
  945.      PKZ110.EXE           1.10    PKZIP.EXE &
  946.                                   PKUNZIP.EXE   Process *.zip files
  947.      TDCHECK.ZIP           1.1    TDCHECK.EXE   Test TD0 files for
  948.                                                 integrity
  949.      GIF2JPG.ZIP           1.5    Gif2JPG.EXE &
  950.                                   JPG2GIF.EXE   Compress Gif files
  951.      GIFLITE.ZIP           1.4    GIFLITE.exe   Compress Gif files
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.                              Most Common Problems
  964.                       ===================================
  965.  
  966.  
  967.      Q:   Catscan runs so fast it doesn't seem like it does anything?
  968.  
  969.      A:   Make sure your SCANFLE.BAT file reads like the above example
  970.           CatScan does not use /S or /F in the command line anymore.
  971.  
  972.  
  973.      Q:   I Get a run time error 5 when the program starts to run.
  974.  
  975.      A:   Make sure you have filenames listed in the config. For example,
  976.           you might have left of the CATSCAN.KEY on the question Where is
  977.           your .KEY file.  It Should look something like this:
  978.           C:\DOS\CATSCAN.KEY (not you might have left CATSCAN.KEY off).
  979.           This needs to be done for several of the config questions like;
  980.           BADNAMES.TXT, CATSCAN.KEY, TXTNAMES.TXT, RUNLATER.TXT.
  981.  
  982.      Q:   Catscan does not show on the remote computer, it just says
  983.           Scanning/Checking file.
  984.  
  985.      A:   Catscan could not find DOOR.SYS  make sure that you are changing
  986.           to a node home directory before you start up Catscan. If Catscan
  987.           can find DOOR.SYS then it will automaticly go out the com port.
  988.           If you use the %WCNODEID% variable to change to the node home
  989.           directory make sure that you have defined that varible to the
  990.           corrent node id.  To verify that it is set correctly type in SET
  991.           at the Dos prompt and it will show you what its value is. If it
  992.           doesn't appear then it hasnt been set.
  993.  
  994.  
  995.      Q:   Catscan works fine on my com1 and com2 line but locks up on my
  996.           com3 line.
  997.  
  998.      A:   You need to setup the %WCIRQID% and the %WCBASEID% environment
  999.           variables.  You are running nonstandard IRQ and Base address on
  1000.           your comport so this is how you tell Catscan which ones to use.
  1001.           It should be set up anyway for wildcat to run correctly unless
  1002.           the node that is running it is getting it's values from makewild,
  1003.           in which case you must set these varibles anyway just for catscan
  1004.           and some doors.
  1005.  
  1006.  
  1007.      Q:   Catscan is not marking the file as failed when it runs into a
  1008.           failed file.  It says failed in the log but wildcat still says
  1009.           passed..
  1010.  
  1011.  
  1012.      A:   Your not running Catscan from the node home directory.  IE.
  1013.           \wc30\wcwork\node1  look at the example SCANFILE.BAT inculded in
  1014.           the catscan archive.
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.      Support BBS's
  1024.      -----------------------------
  1025.  
  1026.      The Software Connection BBS
  1027.      Fido: 1:281/2   Freq: CATSCAN
  1028.      (913) 271-2070  USR DS  14400  (LOCKED)
  1029.            271-2071  USR DS  16800  (LOCKED)
  1030.            271-2072  USR DS  14400  (LOCKED)
  1031.            271-2073  USR DS  14400  (LOCKED)
  1032.            271-2074  USR HST 14400  (LOCKED)
  1033.            (USA)
  1034.  
  1035.      The City Limits BBS
  1036.      Fido: 1:281/12  Freq: CATSCAN
  1037.      (913) 357-6864  HST 14400 (Locked)
  1038.            357-0322  2400 Baud
  1039.            (USA)
  1040.  
  1041.  
  1042.      The SPooK BBS
  1043.      Fido: 2:440/18   Freq: CATSCAN
  1044.            44-268-767365  HST (LOCKED)
  1045.            (ENGLAND)
  1046.  
  1047.  
  1048.  
  1049.                                 Special Thanks
  1050.                          ============================
  1051.  
  1052.      Special thanks go to Scott Green for helping me in many ways make
  1053.      catscan what it is today. Derek Koopowitz for his great help to me on
  1054.      how to update the Wildcat database.  Robert Warren for making the
  1055.      graphics screen displayed to the User while catscan runs. The Wildcat
  1056.      Alpha team for their initial support in the program and desire to see
  1057.      something good fo Wildcat.  The Wildcat Beta team for not flaming me
  1058.      to death on some of the bugs they found.  And a very special thank you
  1059.      to all of those who have already sent in their registrations I guess a
  1060.      good utility speaks for its self in registrations my mailbox has not
  1061.      been empty except for Sundays.
  1062.  
  1063.      Thank you all Very Much.
  1064.  
  1065.  
  1066.                                   Mike Ortiz
  1067.  
  1068.  
  1069.